home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Auge 4000 / Auge 4000 #45 (1990-06-20)(Amiga User Gruppe Einzugsgebiet 4000).zip / Auge 4000 #45 (1990-06-20)(Amiga User Gruppe Einzugsgebiet 4000).adf / ANWENDUNGEN / Ncomm / NComm.doc < prev    next >
Text File  |  1990-06-08  |  68KB  |  1,523 lines

  1.  
  2.  
  3.  
  4.               NComm 1.9 - released the 8th of April, 1990
  5.  
  6.                                              //
  7.                 A terminal program for the \X/ AMIGA
  8.  
  9. ======================================================================
  10.  
  11. --- INDEX ---
  12.  
  13. 1.  INTRODUCTION
  14.  
  15.     1.1  Distribution info     1.7  Manual info
  16.     1.2  Version Number        1.8  How to contact the authors
  17.     1.3  Development info      1.9  Future expansion
  18.     1.4  History               1.10 Disclaimer
  19.     1.5  Credits               1.11 Summary of functions
  20.     1.6  Programming info
  21.  
  22. 2.  SETUP AND FILES USED
  23.  
  24.     2.1  Files included
  25.     2.2  Information about NComm Host Script
  26.     2.3  Change in file formats
  27.     2.4  How to install new files
  28.     2.5  How to setup NComm: assignment
  29.     2.6  Using your own NewCLI command
  30.     2.7  Using multiple serial ports
  31.     2.8  Startup and command line option
  32.     2.9  Single-drive note
  33.     2.10 How to configure NComm for use with MBBS
  34.     2.11 A note about Ymodem-G and high speed modems
  35.     2.12 Icon stack size
  36.  
  37. 3.  COMMANDS IN SYSTEM MENU
  38.  
  39.     3.1   Commands available   3.7.1 Control characters
  40.     3.2   About NComm          3.7.2 Load Macrokeys
  41.     3.3   Status window        3.7.3 Save Macrokeys
  42.     3.3.1 Send delay           3.7.4 Leaving things unchanged
  43.     3.3.2 Scrollback buffer    3.7.5 Installing new macrokeys
  44.     3.4   Load configuration   3.8   Output to printer
  45.     3.5   Save configuration   3.9   Starting a new CLI
  46.     3.6   Execute script       3.10  Logging calls
  47.     3.7   Macrokeys window     3.11  Quit NComm
  48.  
  49. 4.  THE "FILE INPUT" REQUESTER
  50.  
  51. 5.  COMMANDS IN FILE MENU
  52.  
  53.     5.1   Commands available   5.7.5 Zmodem and HST note
  54.     5.2   ASCII capture        5.8   Options
  55.     5.3   ASCII send           5.8.1 CRC
  56.     5.4   Message upload       5.8.2 View transfers
  57.     5.5   Download             5.8.3 Chop files
  58.     5.6   Upload               5.8.4 G&R protocol
  59.     5.7   Protocol             5.8.5 G&R host mode
  60.     5.7.1 Xmodem               5.8.6 Zmodem resume
  61.     5.7.2 Ymodem               5.9   Default directory
  62.     5.7.3 Ymodem-Batch         5.10  View scrollback buffer
  63.     5.7.4 Ymodem-G             5.11  Save scrollback buffer
  64.  
  65. 6.  COMMANDS IN SERIAL MENU
  66.  
  67.     6.1   Commands available   6.6.2 Half duplex
  68.     6.2   Baud                 6.7   Handshaking
  69.     6.3   Data length          6.7.1 None
  70.     6.4   Parity               6.7.2 Xon / Xoff
  71.     6.5   Stop bits            6.7.3 RTS / CTS
  72.     6.6   Duplex               6.8   Send break
  73.     6.6.1 Full duplex
  74.  
  75. 7.  COMMANDS IN TRANSLATE MENU
  76.  
  77.     7.1    Commands available  7.3.7  UK7
  78.     7.2    End of line         7.3.8  GE7
  79.     7.3    Character set       7.3.9  FR7
  80.     7.3.1  ISO                 7.3.10 SP7
  81.     7.3.2  IBM                 7.3.11 IT7
  82.     7.3.3  IBN                 7.3.12 SF7
  83.     7.3.4  IBP                 7.3.13 DE7
  84.     7.3.5  NO7                 7.4    Del <-> BS
  85.     7.3.6  US7                 7.5    Show HEX chars
  86.  
  87. 8.  COMMANDS IN SCREEN MENU
  88.  
  89.     8.1    Commands available  8.6    Split screen
  90.     8.2    Title bar           8.7    Style
  91.     8.3    Interlace           8.8    Bell
  92.     8.4    Colours             8.9    Reset
  93.     8.5    Palette             8.10   Window Gadgets
  94.  
  95. 9.  COMMANDS IN PHONE MENU
  96.  
  97.     9.1    Commands available  9.6.6  Disconnect string
  98.     9.2    Phonebook           9.6.7  Connect string
  99.     9.2.1  Dial                9.6.8  Busy string
  100.     9.2.2  Edit                9.6.9  Redial delay
  101.     9.2.3  New                 9.6.10 Auto-speed and HST info
  102.     9.2.4  Abort               9.6.11 Accepting the edit
  103.     9.2.5  Load                9.7    Phonebook edit window
  104.     9.2.6  Save                9.7.1  Name
  105.     9.2.7  Delete              9.7.2  Phone #
  106.     9.2.8  Sort                9.7.3  Comment
  107.     9.2.9  Print               9.7.4  Config
  108.     9.3    Dial #              9.7.5  Macros
  109.     9.4    Hang up             9.7.6  Script
  110.     9.5    Redial              9.7.7  Password
  111.     9.6    Modem setup         9.7.8  Baud rate
  112.     9.6.1  Init string         9.7.9  Data length
  113.     9.6.2  Exit string         9.7.10 Parity
  114.     9.6.3  Dial prefix         9.7.11 Stop bits
  115.     9.6.4  Dial suffix         9.7.12 Duplex mode
  116.     9.6.5  Hang-up string      9.7.13 Character set
  117.  
  118. 10. INFORMATION ABOUT DIAL MENU
  119.  
  120. 11. HOT KEYS AVAILABLE
  121.  
  122. ======================================================================
  123.  
  124.  
  125.  
  126. CHAPTER 1: INTRODUCTION
  127.  
  128. 1.1  NComm is now GiftWare. This means that if you think we desverve a
  129.      contribution,  feel  free  to  send  us  a  gift  (beer, cookies,
  130.      chocolate, whisky, Alka-Seltzer,  68030 cards  etc. ;-) Thanks to
  131.      Frederick  Page  for  giving  us  this  idea  by sending a box of
  132.      "Aachener Printen" cookies 8-)
  133.  
  134.      NComm  is  freely  distributable  and is intended for personal use
  135.      only.  Sale  of  this program except for REASONABLE media costs is
  136.      prohibited.
  137.  
  138. 1.2  NComm  1.9  written  by  Daniel  Bloch.  Based on Comm 1.34 by Dj
  139.      James.
  140.  
  141. 1.3  This  program  was  developed  using  Lattice  C 5.05, and is the
  142.      result  of a project started in Oslo in 1988, using the Rodeløkka
  143.      (M)BBS to coordinate the initial efforts.
  144.  
  145. 1.4  Many  of  the  communication  programs on the market today *look*
  146.      nice,  but after testing them for a few minutes you find out that
  147.      they  are  so bug-ridden that even the old Basic-program you used
  148.      on the Commodore 64 would be preferable.
  149.  
  150.      We  thought  that  no  Amiga  communication program fulfilled our
  151.      needs,  and  figured  out that the only way to get a program that
  152.      did  everything we wanted, was to make it ourselves!  Luckily the
  153.      source  for  Comm  1.34  was  available.   It  had  all the basic
  154.      functions,  so  we  could  concentrate  on  what  we  thought was
  155.      missing.
  156.  
  157.      Our  goal  wasn't  to  make a program with a lot of functions you
  158.      never  use,  but with the functions that we needed - and they had
  159.      to   work!    Our  national  characters  have  been  ignored  and
  160.      mistreated, but NComm puts an end to that.
  161.  
  162. 1.5  The  project  was  led by Daniel Bloch, and chief contributors to
  163.      the design so far, apart from Daniel, have been:
  164.  
  165.      Trym Hansen        Conrad Helgeland      Torkel Lodberg
  166.      Jørn Lokøy         Per Hansen            Geir Atle Storhaug
  167.      Arvid Johansen     Geir Inge Høsteng     Anders Herbjørnsen
  168.      Bjørn Melbye       Eric Wheatley         Marek Rzewuski
  169.      Heiko Schlichting  Miguel Casteleiro     Øyvind Harboe
  170.  
  171.      Thanks   go   to  Mike  Robertson  (who  gave  us  the  necessary
  172.      information  for  the  G&R protocol, and helped us out with a few
  173.      other  things),  Dj  James  (for  the source to Comm 1.34) and to
  174.      Carolyn Scheppner (for the colour palette source).
  175.  
  176.      Also  thanks to all the Beta-testers.  Feedback from the users is
  177.      the most important thing when developing a program!
  178.  
  179.      Phone icon created by Bjørn Rybakken - thanks!.
  180.  
  181. 1.6  All  programming  by Daniel Bloch, with help from Torkel Lodberg.
  182.      Phonebook  made  by  Trym  Hansen.  The File Input requester from
  183.      Charlie  Heath  was  enhanced by Daniel Bloch and Torkel Lodberg.
  184.      Scrollback made by Torkel Lodberg.
  185.  
  186. 1.7  This manual is based on the original Comm manual.  It was written
  187.      by  Torkel  Lodberg,  with  help  from  Conrad Helgeland and Eric
  188.      Wheatley.
  189.  
  190. 1.8  We  welcome  bug  reports  and  comments  about  NComm  and   the
  191.      documentation.  Send your comments to this address:
  192.  
  193.         Daniel Bloch, Fyrstikkbakken 9, N-0667 Oslo 6, Norway.
  194.             Email: danielb@ifi.uio.no    (Internet)
  195.                    ...!mcvax!ifi!danielb (Usenet)
  196.                   d_bloch_d@inger.uio.no (Internet)
  197.                 Daniel Bloch @ 2:502/110 (Fidonet)
  198.  
  199.      Or call: Rodeløkka (M)BBS at 300-2400 baud, 24hrs, two nodes.
  200.  
  201.               Phone # +47 2 380949 (international)
  202.                        (02) 380949 (Norway)
  203.  
  204.               ====================================================
  205.  
  206.               The Amiga BBS, 24 hours, 124 mb, two nodes, MNP5.
  207.               FidoNet node # 2:502/110
  208.  
  209.               Node 1: +47 2 493210 (300 - 14400 baud (HST))
  210.               Node 2: +47 2 495201 (1200 - 9600 baud (V.32))
  211.  
  212. 1.9  A  probable  future expansion is the addition of more  protocols.
  213.      We  welcome  debugged and documented C-source of other protocols,
  214.      as lack of time prevents us from writing them ourselves...
  215.  
  216.      A  final  note:  Please read this documentation carefully.  Most
  217.      things should be explained here.
  218.  
  219. 1.10 Disclaimer:
  220.      -----------
  221.      We  have  made  every  effort  possible to ensure that NComm will
  222.      function  as described, but no warranty of any kind, expressed or
  223.      implied, is  made by us.  We will not be liable for any direct or
  224.      indirect  damages  to  either machinal equipment or mental health
  225.      arising  from  a  failure of the program to operate in the manner
  226.      desired  by the user.  In no event will we be liable for any loss
  227.      of profits or savings.
  228.  
  229. 1.11 Summary of functions:
  230.  
  231.         o Works on any Amiga with 512K RAM or more. Menu driven.
  232.         o ANSI / VT100 terminal emulation with full 8 colour text
  233.           support. IBM graphics (optional). Optional translation of
  234.           styles. Interlaced screen (optional). PAL and NTSC support.
  235.           Works with WB overscan.
  236.         o Full support for all European languages (both character-
  237.           sets and keymaps). Thirteen translation modes.
  238.         o Baud rates up to 19200 baud supported.
  239.           Xon/Xoff and CTS/RTS handshaking. Fast screen I/O.
  240.         o Fast file transfer protocols:  ASCII, Xmodem, Xmodem-CRC,
  241.           Ymodem, Ymodem-Batch, Ymodem-G (for error correcting modems).
  242.           FAST Zmodem protocol using external library. Autochop on
  243.           receive files - disabled for ARC, ZOO, PAK, ZIP.
  244.           Optional translation. View transfer option.
  245.         o Autodownload feature for MBBS or systems with G&R protocol.
  246.           G&R host mode.
  247.         o Script language - simple text language automates sessions.
  248.           Advanced Host-Mode and MBBS/Paragon scripts follows program.
  249.         o Optional scrollback buffer - view or save text that
  250.           previously has been displayed on screen.
  251.         o Hot Keys for most program functions, including dialling of
  252.           up to 10 phone numbers.
  253.         o Split screen mode for conferencing.
  254.         o Dialling directory, queued dial, redial until carrier
  255.           received.
  256.         o Support for non-Hayes type modems.
  257.         o 46 entry fast phonemenu. Phone requester with unlimited
  258.           entries.
  259.         o 20 keyboard macros using function keys.
  260.         o Optional real time printing of incoming text.
  261.         o Internal multitasking.
  262.         o Log writes.
  263.  
  264. CHAPTER 2: PREPARATION
  265.  
  266. 2.1  The following files should be included in this package:
  267.  
  268.           Install                          Install.info
  269.           Mbbs.script                      NComm
  270.           NComm.config                     NComm.doc
  271.           NComm.doc.info                   NComm.info
  272.           NComm.keys                       NComm.news
  273.           NComm.news.info                  NComm.phone
  274.           NComm1.8                         NComm1.font
  275.           NComm2.8                         NComm2.font
  276.           Paragon.script                   Script.doc
  277.           Script.doc.info                  XPRZmodem.library
  278.           PbConvert                        PbConvert.c
  279.           PbConvert.doc                    PbConvert.doc.info
  280.           PbConvert.info
  281.  
  282.      Be  careful  not  to  mix these files with old Comm 1.34 or NComm
  283.      1.01  files   that  may  be  lying  around.   The  datafiles  are
  284.      incompatible.
  285.  
  286.      In the directory 'host', you will find the following files;
  287.  
  288.           blist                            bull1
  289.           bull2                            host.config
  290.           host.doc                         host.script
  291.           menu0                            menu1
  292.           menu2                            menu3
  293.           postlog                          prelog
  294.  
  295. 2.2  Read  the  file  'host.doc'  for information about the NComm Host
  296.      Script.
  297.  
  298. 2.3  The  NComm.config  format  has been changed since NComm 1.8.  All
  299.      configuration  files  should  be deleted!  The NComm.phone format
  300.      has  also   been  changed, convert old phonebook files to the new
  301.      format  using  the  program PbConvert. See the file PbConvert.doc
  302.      for information about how to use this program.
  303.  
  304. 2.4  NComm  uses two fonts to emulate  IBM graphics.  They must reside
  305.      in  the directory named FONTS:.  It also uses an external library
  306.      that contains the Zmodem protocol.
  307.  
  308.      If  this  copy  of NComm was downloaded as an archive file, enter
  309.      the  following  command in CLI (or just click on the Install icon
  310.      from WorkBench):
  311.  
  312.      1> Execute Install
  313.  
  314.      This  batchfile  will  copy  the  font files used by NComm to the
  315.      FONTS:   directory.  First  (of course) you have to assign FONTS:
  316.      to  the  directory  where you keep your fonts.  Unless you assign
  317.      these  fonts correctly, the IBM graphics emulation will not work!
  318.  
  319.      Important!
  320.      ----------
  321.      Users  of  NComm  V1.8  should reinstall the fonts, since a small
  322.      bug has been found in the font set. Also, a few other changes has
  323.      been made due to a new portuguese character set.
  324.  
  325.      The  batchfile  will also copy the XPRZmodem.library to the LIBS:
  326.      directory.   This  is  a  public  domain  Zmodem library that was
  327.      created  by  Rich  Huebner  -  thanks  a  lot!  The file  MUST be
  328.      present,  or  the Zmodem protocol won't work!  The version number
  329.      included is 2.0.
  330.  
  331.      Finally, the  batchfile file will set up an NComm:  assignment to
  332.      the current directory.
  333.  
  334.  
  335. 2.5  Data files
  336.      ----------
  337.      It  is  important  for  NComm  to know where it can find its data
  338.      files,  and  we must help it on its way.  If NComm was unarced in
  339.      the  ROOT  directory  of  a  floppy  disk,  relabel  the  disk as
  340.      "NComm".   This  can  be  done  by the following command if NComm
  341.      resides on df1:
  342.  
  343.          1> Relabel drive df1: name "NComm"
  344.  
  345.      If  the  files  were unarced within a directory or on a harddisk,
  346.      you  must  assign "NComm:" to the directory that NComm resides in
  347.      including full device and path names.
  348.  
  349.      Examples:
  350.  
  351.          1> Assign NComm: "df1:"
  352.  
  353.      ...expects NComm to reside in the ROOT directory of drive "df1:"
  354.  
  355.          1> Assign NComm: "dh0:NComm 1.9"
  356.  
  357.      ...expects NComm to reside in directory "NComm 1.9" on "dh0:"
  358.  
  359.      If  you  do  not  wish  to  name  the  disk that NComm resides on
  360.      'NComm',   it   is   probably   a   good   idea   to   edit   the
  361.      "s:startup-sequence"  file  and  add  the assign command that you
  362.      just entered.
  363.  
  364. 2.6  NComm  has  an  inbuilt  command  for opening a new CLI. If NComm
  365.      should  not  use the normal "NewCLI" command for opening the CLI,
  366.      this  can  be  done  by  using t he SetEnv command in WB1.3.  For
  367.      example:
  368.  
  369.         1> setenv NEWCLI "NewSHELL *"newcon:0/11/640/245/NCommShell*""
  370.  
  371. 2.7  If   you   want  to  use  NComm  with  other  devices  than   the
  372.      'serial.device',  or  if you have multiple serial ports, this can
  373.      be   set  using  the  environment  variable NCOMMSER.  Here is an
  374.      example for using line 2 of the ASDG Dual Serial Board:
  375.  
  376.         1> setenv NCOMMSER "siosbx.device,1"
  377.  
  378.      Users  of  boards  with  multiple serial ports should notice that
  379.      NComm  opens  the  serial.device  in  "exclusive"  mode.  If  the
  380.      serial.device   could  not  be  opened,  the  message "Can't open
  381.      serial.device"   will be displayed (workbench users will notice a
  382.      flash  on  the  workbench  screen  if  NComm of some reason can't
  383.      run).   It  is  therefore possible to patch NComm to make it work
  384.      with  other  devices,  i.e;  multiple  copies  of  NComm  may run
  385.      simultaneosly.
  386.  
  387. 2.8  To start up NComm, enter the following command in AmigaDOS:
  388.  
  389.         1> NComm [filename]
  390.  
  391.      ...where filename is the name of an optional script file.
  392.  
  393.      From WorkBench, just click on the NComm icon.
  394.  
  395. 2.9  Note:
  396.      -----
  397.      Single-drive  users  have  to  execute  these  commands  in a bit
  398.      different  manner.  Either  you can copy the needed commands into
  399.      RAM:   and  assign  c:   to  RAM:,  or  you may enter the desired
  400.      commands  with   just  a question mark as command-line.  You will
  401.      then  be  given  a  long  prompt,  at  which you should enter the
  402.      normal   command-line"  with  drive  specified  as  df0:.  As  an
  403.      example, here is how to relabel a disk...
  404.  
  405.      Boot your AmigaDOS disk in df0: and enter this at the prompt:
  406.  
  407.         1> Relabel ?
  408.  
  409.      "DRIVE/A,NAME/A"  now  appears  on the screen.   Now put your new
  410.      NComm disk in df0:  and enter this:
  411.  
  412.         drive df0: name "NComm"
  413.  
  414. 2.10 How to configure NComm for use with MBBS.
  415.      -----------------------------------------
  416.  
  417.      To   get  the  most  from  NComm when using the MBBS program, you
  418.      should   log  in at the MBBS boards you are going to use.  In the
  419.      utility   menu,  there are several options that have to be turned
  420.      on.    Walk  to  the utility menu with the (U)tility command, and
  421.      select  (M)ode  changes.   Answer  'YES'  at  all  prompts.   The
  422.      message  'User  profile  updated'  will  be  displayed.  Now,  if
  423.      you're  using  a  PAL  machine, you probably want to  configure a
  424.      larger number of lines per page than what has been  configured by
  425.      MBBS.  Select  (L)ines  per page, and enter '29' at  the  prompt.
  426.      Finally, select  IBM  graphics by using the (S)et  character  set
  427.      command. Enter 'IBN' at the prompt.
  428.  
  429.      Some   options  must  now  be  turned  on  in NComm.  Walk to the
  430.      'Transfer'  menu, and turn  on the 'G&R Protocol'.  Configure the
  431.      default  directories for these transfers if you don't have enough
  432.      memory  to  use the RAM DISK.  Now, examine that your 'Com' setup
  433.      is  8N1.   Always  use this setup when connecting to MBBS boards,
  434.      otherwise  high  bits  will be stripped.  Turn the 'IBN character
  435.      set'  on in the 'Translate' menu.  Turn the '8 Colour' mode on in
  436.      the  screen menu, and 'Reset' the colours by opening the palette.
  437.      You  now  have  true ANSI graphics!  Remember to save the present
  438.      configuration.
  439.  
  440. 2.11 A note about using NComm with Ymodem-G and High Speed modems
  441.      ------------------------------------------------------------
  442.  
  443.      Characters   may  sometimes  disappear when using NComm with baud
  444.      rates   above  9600 baud.  This is not due to a bug in NComm, but
  445.      is   caused  by  a  problem  with either the serial.device or the
  446.      Amiga   hardware.   It seems to me like the problem actually gets
  447.      worse   if  you  are using RTS/CTS handshaking so try turning off
  448.      this  feature if many errors occur. Also, the problem gets better
  449.      if  you  are  using  a  2-colour  non-interlaced  screen  without
  450.      overscan.
  451.  
  452.      If   you  want  to  perform file transfer with modems like the US
  453.      Robotics  HST,  we   recommend  using  the  Zmodem error checking
  454.      protocol.   It  is  not safe to use the Ymodem-G protocol at high
  455.      baud  rates  even  if the  modem is having MNP available - errors
  456.      may occur!.
  457.  
  458.      We   apologize  for this, and hope this will be fixed in a future
  459.      version  of  the  Amiga  software  or hardware!  We have tried to
  460.      shorten   down  the  cable  between the modem and the machine but
  461.      that   didn't  seem  to  help.  We have checked every other Amiga
  462.      comms  program available, and the same thing seems to happen with
  463.      them.
  464.  
  465. 2.12 If you want to use another icon than the one supplied with NComm,
  466.      remember to set the stack size to 10000 bytes. Otherwise, you may
  467.      experience problems with NComm.
  468.  
  469. CHAPTER 3: COMMANDS IN SYSTEM MENU
  470.  
  471. 3.1  Here  you  control  all system functions.  From here you can load
  472.      and  save  settings, view the status, edit the macrokeys, turn on
  473.      and  off  the  printer, and start a new CLI.  You can also choose
  474.      whether  NComm should add entries to the logfile when you connect
  475.      with  a  board.   You  may  also exit NComm from here, as well as
  476.      execute script-files.
  477.  
  478. 3.2  About NComm
  479.         Will tell you a few things about NComm and the author.  Simply
  480.         click in the window to close it...
  481.  
  482. 3.3  Status
  483.         This  will  bring  up  a  status display showing the amount of
  484.         memory  available, the state of the printer and capture buffer
  485.         toggles.  If  the  capture  buffer  has  been  turned  on, the
  486.         filename will also be displayed.
  487.  
  488.         Here  you  will  also  find  a  slider gadget for use with the
  489.         "ASCII  send"  and  "message  send"  functions.  Some Bulletin
  490.         Board  Systems  lose  data  if is being sent too fast, so this
  491.         function can be very useful.
  492.  
  493. 3.3.1   You  can  select  a  time  to  delay  after  transmitting each
  494.         character  by  using  this  slider  gadget.  The gadget can be
  495.         adjusted from approx  20ms  (Fast)  to  300  ms  (Slow)  delay
  496.         between  transmitted  characters.   The slider can be adjusted
  497.         while a file is being sent to allow for fine tuning.
  498.  
  499.         With  the  slider in the (default) far left position, there is
  500.         no delay.
  501.  
  502. 3.3.2   A  scrollback buffer can be set with the second slider gadget.
  503.         This  can  be useful if you often loose CARRIER while entering
  504.         messages  or if you are bothered by pages often scrolling past
  505.         your screen.  Here you can set the buffer size, i.e.  how much
  506.         NComm  at  all  times shall remember of the incoming data.  If
  507.         you are using a 512K Amiga, it may be wise to use only a small
  508.         scrollback  buffer.   Set the scrollback buffer to '0K' if you
  509.         want to turn off this option, or want to clear the buffer.
  510.  
  511. 3.4 Load config
  512.         Will load a new NComm configuration.  All menu options and the
  513.         status  window  settings  are  covered  by this function.  The
  514.         macrokeys and the phonebook must be loaded separately.  A file
  515.         input requester will appear in the center of the screen.  Only
  516.         files with a ".config" suffix will be shown.
  517.  
  518.         For  instructions on  how to  use the file requester, see "The
  519.         file input requester" below.
  520.  
  521. 3.5 Save config
  522.         Will  save  the current NComm configuration.  All menu options
  523.         and  the  status window settings are covered by this function.
  524.         The  macrokeys  and the phonebook must be saved separately.  A
  525.         file  input requester will appear in the center of the screen.
  526.         For  instructions  on  how  to  use  this, see "The file input
  527.         requester" below.
  528.  
  529. 3.6 Script
  530.         This  function  will  execute  a  scriptfile.   A  file  input
  531.         requester  will  appear  in  the  center  of  the screen.  For
  532.         instructions   on  how  to  use  this,  see  "The  file  input
  533.         requester" below. Select the script you want to run. The  text
  534.         'SCR' will be displayed on the status line. To stop a  script,
  535.         select  this  entry  again.  See  the  file  "Script.doc"  for
  536.         detailed  information on scripts.
  537.  
  538. 3.7 Macrokeys
  539.         This  will  bring  up  a  requester  that  lets  you  edit the
  540.         macrokeys.   Here  you  may  also load new macros and save the
  541.         text  stored  on  the  different macrokeys.  The function keys
  542.         definable  are  F1  to  F10  and  SHIFT  F1  to  F10.  A macro
  543.         definiton  can  be 512 bytes maximum.  Not all keys have to be
  544.         defined.   To  edit a macro just click in one of the requester
  545.         text  input  boxes  and enter your definition.  The macros can
  546.         contain  control  characters  which  can be represented in two
  547.         ways.   These  characters  can also be used in the modem setup
  548.         requester.
  549.  
  550. 3.7.1           1.    C-style   slash   conventions.    The  following
  551.                       sequences are supported:
  552.  
  553.                     \n, \r      Carriage Return
  554.                     \t          Tabulator
  555.                     \f          Form Feed
  556.                     \b          BackSpace
  557.                     \v          Vertical Tabulator
  558.                     \e          Escape
  559.                     \\          Backslash
  560.                     \"          Quote
  561.                     \p          Phonebook Password
  562.                     \w          .5 second Delay
  563.                     \l          250 ms Line Break
  564.                     \m          Macro
  565.  
  566.                 2.    The   caret   followed   by  a  letter,  meaning
  567.                       CTRL+letter.    If   you   need  the  line  feed
  568.                       character, for example, use ^J.
  569.  
  570.         You  can have nested macros by using the \m## option, where ##
  571.         is a number from 1 to 20 - with 1 representing macro F1 and 11
  572.         and 20 representing Shift F1 and Shift F20 respectively.
  573.  
  574.         Examples:
  575.  
  576.         commodore            ;Will not add a carriage return.
  577.         at \\N3\n            ;AT \N3 plus a carriage return.
  578.         ^pread               ;The control-P code, followed by 'read'.
  579.         \m1\m2run testfile\r ;The text stored on macro F1 and F2, plus
  580.                              ;the text 'run testfile' and a CR.
  581.  
  582. 3.7.2   Selecting  the 'Load' gadget will bring up a file requester in
  583.         the  center  of  the  screen.   For instructions on how to use
  584.         this, see "The file input-requester" below.  From here you may
  585.         load new macrokeys.  Remember to save the current macrokeys if
  586.         any  changes  have been made.  Entering "NComm.keys" will load
  587.         the macrokeys that are normally loaded at startup.
  588.  
  589. 3.7.3   Selecting  the 'Save' gadget will bring up a file requester in
  590.         the  center  of  the  screen.   For instructions on how to use
  591.         this, see "The file input-requester" below.  From here you may
  592.         save  the  current  macrokeys.  Enter the name "NComm.keys" if
  593.         you want the macrokeys to be loaded on startup.
  594.  
  595. 3.7.4   Selecting  the 'Cancel' gadget will leave everything unchanged
  596.         and remove the macrokeys window.
  597.  
  598. 3.7.5   Selecting  the  'OK'  gadget will close the window and install
  599.         the new macros.
  600.  
  601. 3.8 Printer
  602.         Toggles  the  printer ON/OFF.  When ON, text received from the
  603.         serial  port will also go to the printer via the PRT:  device.
  604.         The text 'PRT' will be displayed on the status line.
  605.  
  606. 3.9 New CLI
  607.         Works  like the "NewCli" command.  Will open up a command line
  608.         interface  on the Workbench screen.  Type 'EndCli' to exit the
  609.         CLI and return to NComm.
  610.  
  611. 3.10 Log Calls
  612.         When  this  option is turned on, NComm will log all calls made
  613.         within  NComm.  The  information  will  be added to a textfile
  614.         called "NComm.log".
  615.  
  616. 3.11 Quit NComm
  617.         Selecting this entry will close all open files and windows and
  618.         exit back to the operating system.
  619.  
  620.  
  621.  
  622. CHAPTER 4: FILE REQUESTER INFO
  623.  
  624.      The File Input Requester
  625.      ------------------------
  626.      Many  functions  call upon a file name.  The file input requester
  627.      then appears on the screen with a sorted directory listing of the
  628.      current directory in the window.
  629.  
  630.      At  the bottom of the requester, eight devices are displayed.  To
  631.      change  the  current  device,  click  in one of these boxes - the
  632.      device must be available on your system (i.e not ghosted) for you
  633.      to chose it.
  634.  
  635.      To  enter  a  directory,  position the pointer over the directory
  636.      name   and  click  once  or  enter  the  directory  name  in  the
  637.      'Directory' string gadget.
  638.  
  639.      The 'PARENT' gadget will move you back one directory - i.e.  this
  640.      will  cause  the  parent  directory  to  be  displayed, if such a
  641.      directory exists.
  642.  
  643.      You  may  select  a  filename by positioning the pointer over it.
  644.      Open  the  file  by  doubleclicking,  or by first clicking on the
  645.      filename  and afterwards on the 'OK' gadget.  Alternatively, type
  646.      the  name  of the desired file in the requester marked 'File' and
  647.      press Return.
  648.  
  649.      In  the  'Type' string gadget, enter an optional extension.  This
  650.      will  display  only  the  files  with  that suffix.  For example,
  651.      entering ".TXT" will display only the textfiles.
  652.  
  653.      The  window  only has room for 10 entries.  To scroll through the
  654.      directory, use the dragbar.
  655.  
  656.      The  number of bytes free on the current device will be displayed
  657.      in  the  middle  of  the  two  gadgets.  Always check if there is
  658.      enough space on the current device before downloading files.
  659.  
  660.      The  'Directory'  string  gadget  will  be active when the window
  661.      opens.   Pressing  Return  will  move  the cursor directly to the
  662.      'File'  gadget.   This  can  be  handy if you don't want to mouse
  663.      around.
  664.  
  665.      Use  the  upper right depth-arrangers to move the window in front
  666.      or in back of other windows.
  667.  
  668.      Selecting 'CANCEL' will abort the operation.
  669.  
  670.      Note:
  671.      When the file requester is on screen (active), you can still send
  672.      and  receive  data.   Sorting  and displaying the files on a disk
  673.      takes  some  time;  you may want to bring up the requester early,
  674.      and  continue  talking  to  the remote system while this is being
  675.      done.
  676.  
  677.  
  678.  
  679. CHAPTER 5: COMMANDS IN FILE MENU
  680.  
  681. 5.1  This  is  the  file  transfer  menu.   From  here you can start a
  682.      transfer  and select the different transfer options i.e protocol,
  683.      handshaking etc.
  684.  
  685.      When  the  upload  or download function is selected, a file input
  686.      requester  will  appear, that is if you have not selected the G&R
  687.      mode.  Again, turn to "The File Input Requester" for instructions
  688.      on how to use this...
  689.  
  690. 5.2 Start ASCII Capture
  691.         All  data received from the serial port is also saved into the
  692.         named  file.   The text is buffered and written to the disk in
  693.         8K blocks.  If you are using a translation table, the incoming
  694.         data  will  be  translated.  Select the 'ISO' character set to
  695.         avoid this.
  696.  
  697.         When  this  mode  is  selected,  the text in the MENU entry is
  698.         changed  to  "Stop  ASCII Capture".  Selecting this entry will
  699.         flush the data buffer to the disk and close the file.
  700.  
  701.         When  capturing  is enabled, the word "CAP" will be visible on
  702.         the status line.
  703.  
  704.         When entering a filename for data capture, NComm will check to
  705.         see if this file already exists.  If it does, a requester will
  706.         appear  informing  you  of  that fact.  You may then choose to
  707.         CONTINUE  using  the  filename  entered  or  CANCEL  and enter
  708.         another  filename.   If  you  choose  to CONTINUE, you will be
  709.         presented  with another requester.  You can APPEND data to the
  710.         existing  file  or  DELETE  the existing data and start with a
  711.         fresh file.
  712.  
  713. 5.3 Start ASCII Send
  714.         The  named  file will be read and sent to the serial port.  If
  715.         the  file  does  not  exist,  a message to that effect will be
  716.         printed.   If  you are using a translation table, the outgoing
  717.         data  will  be  translated.   Select  the 'ISO' translation to
  718.         avoid this.
  719.  
  720.         When  this  mode  is  selected,  the text in the MENU entry is
  721.         changed  to "Stop ASCII Send".  Selecting this entry will stop
  722.         the transfer and close the disk file.
  723.  
  724. 5.4 Message upload
  725.         The  named  file will be read and sent to the serial port.  If
  726.         the  file  does  not exist, a warning message will be printed.
  727.         If  you  are using a translation table, the outgoing data will
  728.         be translated.  Select the 'ISO' translation to avoid this.
  729.  
  730.         This function will perform almost like "Start ASCII send", but
  731.         the  message  will  be packed.  Blank lines will be translated
  732.         into  spaces.   This  can  be useful when uploading to systems
  733.         with  a  certain  pagewidth, or if your message contains blank
  734.         lines  (usually  you  will  exit  the editor when a blank line
  735.         occurs in a message you upload with the ASCII send function.)
  736.  
  737.         Select  this  entry  again  to stop the transfer and close the
  738.         disk file.
  739.  
  740. 5.5 Download
  741.         The  named  file  will be created on the disk and the transfer
  742.         will  be  started  using the protocol you have selected in the
  743.         TRANSFER menu.
  744.  
  745.         If the specified file already exists, a requester will appear;
  746.         asking  if  you  want  to  CONTINUE  or CANCEL the use of that
  747.         filename.   Selecting CONTINUE will overwrite the old existing
  748.         file  with  the  new  one.  Selecting CANCEL will bring up the
  749.         INPUT WINDOW allowing you to enter another file name.
  750.  
  751.         A  window will pop up that among other things will display the
  752.         name  of  the  file  being transferred, a running total of the
  753.         bytes  received,  the  number of NAKs and the last block to be
  754.         NAKed.  The transfer can be aborted by hitting the ESC key, or
  755.         by pressing the upper left-hand close gadget.
  756.  
  757.         The  serial  port  parameters  will  be saved and changed to 8
  758.         bits,   no   parity,  1  stop  bit  for  the  transfer.   Upon
  759.         completion, the old settings will be restored.
  760.  
  761. 5.6 Upload
  762.         Use  this selection to transmit a file to a system.  The named
  763.         file  will  be  opened  on  the  disk and the transfer will be
  764.         started  using  the  error  checking  method (CRC or Checksum)
  765.         selected by the receiving end.
  766.  
  767.         If  the specified file does not exist, a requester will appear
  768.         informing  you  of  this  fact.   You  only have the option to
  769.         CONTINUE, which will bring up the INPUT WINDOW allowing you to
  770.         re-enter the filename or CANCEL the upload.
  771.  
  772.         A  window will pop up that among other things will display the
  773.         name  of  the  file  being transferred, a running total of the
  774.         bytes  sent,  the  number of NAKs and the  last  block  to  be
  775.         NAKed.  The transfer can be aborted by hitting the ESC key, or
  776.         by pressing the upper left-hand close gadget.
  777.  
  778.         As   described  in  the  Download  section,  the  serial  port
  779.         parameters  are  temporarily  changed to 8N1 for the transfer.
  780.  
  781. 5.7 Protocol
  782.         Here  you select the protocol you want used for the upload and
  783.         download functions.
  784.  
  785. 5.7.1           XMODEM
  786.         This  is  the protocol originally written by Ward Christensen.
  787.         It is used by almost every type of personal computer.  This is
  788.         a  good  protocol  to  use  if  the line quality is poor.  Its
  789.         biggest  drawback is that it transfers data in 128 byte blocks
  790.         making it slower than YMODEM.
  791.  
  792. 5.7.2           YMODEM
  793.         This  is  basically  XModem-CRC  with  1024 byte blocks.  This
  794.         means  that  there  is less  handshaking,  which  saves  time.
  795.         YMODEM is faster than  XMODEM  as  long as the line quality is
  796.         acceptable.
  797.  
  798. 5.7.3           YMODEM-BATCH
  799.         This  is  a  more  intelligent version of the YMODEM protocol.
  800.         Multiple  files  may  be  sent  as  a packet, and the protocol
  801.         automatically sends information about filename and filesize.
  802.  
  803. 5.7.4           YMODEM-G
  804.         This is basically YMODEM-BATCH without error checking.  It may
  805.         only   be   used   when   two   error  correcting  modems  are
  806.         communicating  with  each  other.   Configure this with boards
  807.         supporting MNP or ARQ. Please see above for a note about using
  808.         this protocol with high speed modems.
  809.  
  810. 5.7.5           ZMODEM
  811.         This  is  currently  one of the fastest file transfer protocol
  812.         available.  With the Zmodem protocol, you may reach a transfer
  813.         rate  around  1760  CPS  with  the  HST.   It  depends  on the
  814.         XPRZmodem.library,  which  should  be  situated  in  the LIBS:
  815.         directory.   A  file is normally sent in 1024 byte blocks, but
  816.         this  changes  depending  on  the  system performance and line
  817.         quality.   The  reason for its outstanding performance is that
  818.         it  uses continuous data-streaming, and doesn't wait for an OK
  819.         from the remote system before sending the next block.  This is
  820.         not only a fast method to transfer data, but is also necessary
  821.         on packet networks.
  822.  
  823. 5.8 Options
  824.  
  825. 5.8.1           CRC
  826.         This  function  selects the type of error checking to be used
  827.         during  Xmodem  transfers.  If  CRC  is  not  turned  on, the
  828.         checksum method will be used.
  829.  
  830.         The  original  Christensen protocol used an 8 bit checksum for
  831.         error checking.  It is about 97% effective in catching errors.
  832.         All  implementations  of  XMODEM  can use the checksum method.
  833.         Only  use  the cheksum method when in doubt, the CRC method is
  834.         much more secure.
  835.  
  836.         A  later  addition  to  the protocol was the 16 bit (two byte)
  837.         Cyclic  Redundancy  Check  (  CRC  )  which  is  about 99.997%
  838.         effective  in  detecting  errors.   Not all implementations of
  839.         XMODEM  can  use  the CRC method.
  840.  
  841. 5.8.2           View Transfers
  842.         This  option  will output the file data to a view window while
  843.         transferring  data.  It is wise only to view files you know to
  844.         be  ASCII because binary files will look like Greek.  However,
  845.         no harm will be done.
  846.  
  847. 5.8.3           Chop Files
  848.         File  transfers  will  increase the size of a file to the next
  849.         largest  multiple  of  128 bytes for XModem transfers and 1024
  850.         bytes  for  YModem.   The  CHOP  FILES  option will remove the
  851.         padding  on the end of the file.  This is always required when
  852.         transferring   executable  binary  files.   CHOPing  files  is
  853.         therefore desired.
  854.  
  855.         Note:
  856.         It is not desireable to CHOP an .ARC, .ZOO, .PAK or .ZIP file.
  857.         As  it  is  very  easy to forget to turn off the CHOP mode for
  858.         these files, NComm will check the receive-filename for such an
  859.         extension.   If  this  is  found,  it will temporarily disable
  860.         CHOPing  for  this file and on completion of transfer the CHOP
  861.         flag will be reset to its previous value.
  862.  
  863. 5.8.4           G & R Protocol
  864.         This  is  an  auto  up/download protocol for use with the MBBS
  865.         system.   You  must  remember to also turn on G&R in your MBBS
  866.         user  account to make it work.  By using this protocol, you no
  867.         longer  have  to  enter  the  desired protocol and filename in
  868.         NComm  when  transferring  files  to  and from an MBBS system.
  869.         This  means that you do not have to deal with the tedious file
  870.         requester.
  871.  
  872. 5.8.5           G & R Host Mode
  873.         This  feature  is meant to be used when two NComm programs (or
  874.         one  NComm and one GLink program) are connected to each other.
  875.         You  may  use a nullmodem cable or two modems. When one of the
  876.         programs  have  been  set  to  utilize  this feature, the file
  877.         transfer  can be controlled from that machine. All you have to
  878.         specify is protocol, filename and up/download.
  879.  
  880. 5.8.6           Zmodem RESUME
  881.         If  this  feature  has  been turned on, NComm will not discard
  882.         existing  data  when  using  Zmodem  download.   Data  will be
  883.         appended  to  the  file  until  the  filesize  is correct.  No
  884.         requester  will  appear.   Turn  this  feature  on  if you for
  885.         example loose carrier during a Zmodem download - you will then
  886.         only have to transfer the bytes that are missing.
  887.  
  888. 5.9 Default directory
  889.         Here  you  may  specify  the default paths and directories for
  890.         uploading  and  downloading.   A  file  requester will appear,
  891.         select  a  path  and directory and click on the OK gadget when
  892.         you  are satisfied with your selection.  NComm will default to
  893.         these  directories, but as long as you are not using the G & R
  894.         protocol,  you  may  change  the  path  and directory yourself
  895.         before an upload or download.
  896.  
  897.         It  may be wise to set these directories to RAM: for fast file
  898.         transfers, since transferring to disk causes a delay.
  899.  
  900. 5.10 View scrollback buffer
  901.         This function will bring up a window containing a proportional
  902.         gadget  and two line-by-line gadgets.  By using these gadgets,
  903.         you  may  view  what  is  stored  in the scrollback buffer and
  904.         perhaps  see  if  it is worth saving.  The scrollback bytesize
  905.         will be displayed in the window header, as well as the current
  906.         buffer position and number of lines. The  cursor keys may also
  907.         be used for moving around;
  908.  
  909.                 Left - Beginning of buffer
  910.           Shifted-Up - Step one page up
  911.                   Up - Step one line up
  912.                 Down - Step one line down
  913.         Shifted-Down - Step one page down
  914.                Right - End of buffer
  915.  
  916.         Press the CloseGadget or ESCape to close  the  window.  Please
  917.         note  that  the scrollback will slo down when using a 8 colour
  918.         screen.
  919.  
  920. 5.11 Save scrollback buffer
  921.         Use  this  function  if you want to save what is stored in the
  922.         scrollback buffer.  A file requester will appear on screen.
  923.  
  924.  
  925.  
  926. CHAPTER 6: COMMANDS IN SERIAL MENU
  927.  
  928. 6.1  Serial device parameters are changed here.
  929.  
  930. 6.2 Baud
  931.         Baud  rates  from  300  to  19200  baud can be selected.  This
  932.         entry,  however, may be overridden by the default baud rate in
  933.         the phonebook.
  934.  
  935.         Note:
  936.         This  selects  the  serial  speed of the port, the actual data
  937.         throughput  rate  depends  upon  whether the capture buffer is
  938.         active,  if  printer  capture  is selected, if a scrollback is
  939.         used  and  upon the screen I/O speed.  With no printer or file
  940.         capture,  the throughput rate depends on the screen I/O speed.
  941.         If you select a baud  rate  greater  than  2400  baud, you may
  942.         lose characters unless handshaking is being used.
  943.  
  944. 6.3 Data Length
  945.         Selects  the  length  of  a  data  word  as 7 or 8 bits.  Most
  946.         computer systems today will operate with 8 bits.
  947.  
  948.         Note  that during binary transfers, serial port data length is
  949.         set   to  8  bits  and  restored  to  the  previous  value  on
  950.         completion.
  951.  
  952. 6.4 Parity
  953.         Selects  ODD,  EVEN or NO parity.  Most computer systems today
  954.         will operate with NO parity.
  955.  
  956.         Note  that  during binary transfers, serial port parity is set
  957.         to NO parity and restored to the previous value on completion.
  958.  
  959. 6.5 Stop Bits
  960.         Selects  the  number  of stop bits transmitted as 1 or 2 bits.
  961.         Most computer systems today will operate with 1 stop bit.
  962.  
  963.         Note that during binary transfers, serial port stop bit length
  964.         is  set  to  1  bit  and  restored  to  the  previous value on
  965.         completion.
  966.  
  967.         The  Amiga hardware does not allow 2 stop bits to be used with
  968.         an 8 bit data word length.
  969.  
  970. 6.6 Duplex
  971.         Selects  whether  NComm  or  the remote system should echo key
  972.         strokes to the screen.
  973.  
  974. 6.6.1   Select  FULL duplex when the remote machine will echo your key
  975.         strokes.  You will normally be using this option.
  976.  
  977. 6.6.2   Select  HALF  duplex when the remote system does not echo your
  978.         key  strokes.   That  is  when  the  remote system seems to be
  979.         responding  to  your commands, but you cannot see what you are
  980.         typing.
  981.  
  982. 6.7 Handshaking
  983.         Enables  or  disables the serial driver check for flow control
  984.         characters.
  985.  
  986. 6.7.1   Select 'None' when you do not wish to use flow control.
  987.  
  988. 6.7.2   Select 'XON/XOFF' when you wish the driver to use the XON/XOFF
  989.         type  of  flow  control.   Normally this is used at baud rates
  990.         greater than 2400 baud to avoid losing characters.
  991.  
  992. 6.7.3   Select  'RTS/CTS' when you wish the driver to use the hardware
  993.         RTS/CTS  type  of flow control.  This should only be used with
  994.         modems which support it.
  995.  
  996.         Note:
  997.         In  some  cases, when the XON/XOFF mode is selected, NComm may
  998.         receive an XOFF character ( noise or otherwise ) and appear to
  999.         be hung -- that is, no characters appear on the screen yet the
  1000.         menus  still  function properly.  Whenever NComm appears to be
  1001.         hung,  typing  a Ctrl-Q will re-start the serial line.  If the
  1002.         problem  was  due  to  an  XOFF  character received, this will
  1003.         restore everything to normal.
  1004.  
  1005. 6.8 Send Break
  1006.         Sends a 250 ms break signal.
  1007.  
  1008.  
  1009.  
  1010. CHAPTER 7: COMMANDS IN TRANSLATE MENU
  1011.  
  1012. 7.1  This is where you define the translation of out- and ingoing data
  1013.      and the special keyboard keys.
  1014.  
  1015. 7.2  End of Line
  1016.         You  can  select how End of Line characters are handled on the
  1017.         screen  and when sent out the serial port.  By default, EOL is
  1018.         just  a  CARRIAGE RETURN character, but you can change this to
  1019.         CR  and  LINEFEED pairs.  Use this option if all text seems to
  1020.         be printed on one line.
  1021.  
  1022. 7.3  Character set
  1023.         NComm offers twelve different translation tables, and they can
  1024.         be selected here.
  1025.  
  1026. 7.3.1           ISO
  1027.         NComm  will  use the standard Amiga character set, without any
  1028.         translation.  This  should  be  used when using Amiga systems,
  1029.         and will only work in 8N1.
  1030.  
  1031.         Please  note;  if no translation of the in or outgoing data is
  1032.         wanted  when  using  the  ASCII  capture or ASCII send option,
  1033.         switch to ISO before transfer.
  1034.  
  1035. 7.3.2           IBM
  1036.         Should  be  used  with  bulletin  boards  running on PC/MS-DOS
  1037.         machines  that use the IBM extended character set.  NComm will
  1038.         utilize  a  special  IBM  font  containg  all  the IBM graphic
  1039.         characters. This will only work in 8N1.
  1040.  
  1041. 7.3.3           IBN
  1042.         Should  be  used  with  Norwegian  bulletin  boards running on
  1043.         PC/MS-DOS  machines  that  use the IBM extended character set.
  1044.         This  is  a  version  of  the  character set that contains two
  1045.         norwegian   characters  that  are  missing  in  IBMs  original
  1046.         character   set.   NComm  will  utilize  a  special  IBM  font
  1047.         containing  all  the  IBM  graphic characters.  This will only
  1048.         work in 8N1.
  1049.  
  1050. 7.3.4           IBP
  1051.         Should  be  used  with  Portuguese bulletin  boards running on
  1052.         PC/MS-DOS  machines  that  use the IBM extended character set.
  1053.         This  is  a  version  of  the character set that contains some
  1054.         special   Portuguese  characters  that  are  missing  in  IBMs
  1055.         original character set.  NComm will utilize a special IBM font
  1056.         containing  all  the  IBM  graphic characters.  This will only
  1057.         work in 8N1.
  1058.  
  1059. 7.3.5           NO7
  1060.         Use this option when the host uses
  1061.         the Norwegian ISO 7 bit standard.
  1062.  
  1063. 7.3.6           US7
  1064.         Use this option when the host uses
  1065.         the American ISO 7 bit standard.
  1066.  
  1067. 7.3.7           UK7
  1068.         Use this option when the host uses
  1069.         the English ISO 7 bit standard.
  1070.  
  1071. 7.3.8           GE7
  1072.         Use this option when the host uses
  1073.         the German ISO 7 bit standard.
  1074.  
  1075. 7.3.9           FR7
  1076.         Use this option when the host uses
  1077.         the French ISO 7 bit standard.
  1078.  
  1079. 7.3.10          SP7
  1080.         Use this option when the host uses
  1081.         the Spanish ISO 7 bit standard.
  1082.  
  1083. 7.3.11          IT7
  1084.         Use this option when the host uses
  1085.         the Italian ISO 7 bit standard.
  1086.  
  1087. 7.3.12          SF7
  1088.         Use  this  option when the host uses
  1089.         the Swedish/Finnish ISO 7 bit standard.
  1090.  
  1091. 7.3.13          DE7
  1092.         Use this option when the host uses
  1093.         the Danish ISO 7 bit standard.
  1094.  
  1095. 7.4 DEL <-> BS
  1096.         Here  you may configure whether the backspace and del keys are
  1097.         to be exchanged.  This can be useful when communicating with a
  1098.         machine that runs Unix, VMS or Tops-20, amongst others.
  1099.  
  1100. 7.5 Show HEX chars
  1101.         This  option  will translate all incoming text to HEX numbers,
  1102.         as  well  as  displaying  the  text to the right.  Perfect for
  1103.         debugging.
  1104.  
  1105.  
  1106.  
  1107. CHAPTER 8: COMMANDS IN SCREEN MENU
  1108.  
  1109. 8.1  This  is  where  you  may  configure what your screen should look
  1110.      like.
  1111.  
  1112. 8.2  Title bar
  1113.         Toggles the title bar on and off
  1114.  
  1115. 8.3  Interlace
  1116.         This  option  will  make NComm use an interlaced screen, which
  1117.         will double the vertical resolution but cause a lot of flicker
  1118.         if   you  haven't  invested  in  a  flicker-fixer  card  or  a
  1119.         long-persistance monitor.
  1120.  
  1121. 8.4  Colours
  1122.         From  here  you  may  choose whether NComm shall use a  2 or 8
  1123.         colour  screen.  If you choose the eight colour mode, you will
  1124.         get full ANSI colour emulation.  Choose the two colour mode if
  1125.         you prefer faster screen updates.
  1126.  
  1127. 8.5  Palette
  1128.         This  will  bring  up  a requester that lets you configure the
  1129.         colours for the current screen mode.  Each screen mode has its
  1130.         own  palette.  Click 'RESET' to use the colours that NComm was
  1131.         shipped with.  To edit a color, click in the color box and use
  1132.         the slider gadgets.
  1133.  
  1134. 8.6  Split Screen
  1135.         This function will divide the screen into two windows, a small
  1136.         one  (  4 lines ) for your typed characters and a larger one (
  1137.         19  lines  when  using  NTSC) for characters received from the
  1138.         modem.
  1139.  
  1140.         You  should  select the half-duplex mode on the host system to
  1141.         prevent  your typed characters from being echoed back into the
  1142.         receive  window.  To exit the split screen mode, select 'Split
  1143.         Screen' from the menu again.
  1144.  
  1145.         Split  screen  mode requires at least 1MB of memory to operate
  1146.         in interlaced mode.
  1147.  
  1148.         Caution:
  1149.         If  you login to a system while in the split screen mode, your
  1150.         password will be echoed in the TX window.  It is best to login
  1151.         in the single screen mode.
  1152.  
  1153. 8.7  Style
  1154.         This  function allows you to turn on or off the translation of
  1155.         the  different  styles (boldface, italics and underline).  The
  1156.         reason  why  this function was included is that the styles are
  1157.         misused  by many bulletin board systems.  The text will appear
  1158.         clearer, and this will also reduce flashing when the screen is
  1159.         scrolling.
  1160.  
  1161. 8.8  Bell
  1162.         From  here  you  can  configure  what  NComm should do when it
  1163.         receives  the  ASCII  "bell"  code.   You can have an ordinary
  1164.         audible   bell   or   a   visible   bell.  You may even select
  1165.         'ScreenToFront',  which  will  bring the NComm screen to front
  1166.         when  the  "bell"  code  is  received.  You may freely mix the
  1167.         three or turn bell off.
  1168.  
  1169. 8.9  Reset
  1170.         This  function  will  clear  the  screen,  turn  off all style
  1171.         settings and reset the colours.
  1172.  
  1173.  
  1174. 8.10            Window Gadgets
  1175.                 --------------
  1176.      The  screen contains hidden gadgets for depth arranging the NComm
  1177.      window.  The depth gadgets are in the upper right hand corner.
  1178.  
  1179.  
  1180.  
  1181. CHAPTER 9: COMMANDS IN PHONE MENU
  1182.  
  1183. 9.1  From   here  you  may  dial  phonenumbers,  edit  the  phonebook,
  1184.      configure the modem and redial, or hang up the phone.
  1185.  
  1186. 9.2 Phonebook
  1187.         This  entry  will bring up the phonebook window, where you may
  1188.         load  or  save  phonebooks,  as  well  as edit, delete and add
  1189.         entries.  The  entries can also be sorted, dialled or printed.
  1190.  
  1191.         When   loaded,   NComm   first   looks   for   a  file  called
  1192.         NComm:NComm.phone.  If not found, the phonebook will be blank.
  1193.  
  1194.         The  phonebook  can consist of an unlimited number of entries,
  1195.         but  only the first 46 will be displayed in the DIAL menu, and
  1196.         only the first 10 can be dialled using hot keys.
  1197.  
  1198.         Only 15 entries can be displayed simultaneously in the window.
  1199.         To scroll through the phonebook, use the right drag bar.
  1200.  
  1201.         You  may select an entry by positioning the  pointer  over  it
  1202.         and then clicking  on the  left mouse button. When an entry is
  1203.         selected,  it  will show up in reverse video.  Several entries
  1204.         can be selected at the same time.
  1205.  
  1206. 9.2.1   Selecting  the  'Dial!'  gadget will dial the entries that are
  1207.         selected,  starting  at  the  top.  This will bring up a small
  1208.         window telling you which board you are calling, and eventually
  1209.         which  is  the  next  to  go.   The  phonebook  window will be
  1210.         removed.    More  entries  can  be  added  while  dialling  by
  1211.         selecting  them  from  the  DIAL  menu,  or by bringing up the
  1212.         phonebook again.
  1213.  
  1214.         If  a  number is busy, the program will continue with the next
  1215.         number  on the list.  If redial has been turned on, NComm will
  1216.         start  over  again  if no connection has been established with
  1217.         any  of  the  numbers  in the queue.  It will not stop until a
  1218.         connection has been established.
  1219.  
  1220.         Abort  the  dialling  by  pressing  the ESC key or closing the
  1221.         window  by  clicking  in the upper lefthand gadget.  To remove
  1222.         the  current entry, press the DEL key.  Press the SPACE key if
  1223.         you would like to go on with the  next  entry.  You  may  also
  1224.         click within the window gadgets.
  1225.  
  1226. 9.2.2   Selecting  the  'Edit'  gadget  will bring up the edit window,
  1227.         containing  the  information  about  the first entry selected.
  1228.         This  information  can  then  be  edited.   See below for more
  1229.         information  about  how  to use the edit window.  Pressing the
  1230.         'OK'   gadget  will  accept  the  edit,  'Cancel'  will  leave
  1231.         everything unchanged.
  1232.  
  1233. 9.2.3   Selecting  the  'New'  gadget will add a new entry in front of
  1234.         the  first  entry  selected.   However,  if  no entry has been
  1235.         selected,  the entry will be placed at the bottom of the list.
  1236.         This  will bring up a special edit window  that  contains  the
  1237.         current  NComm settings.  See below for more information about
  1238.         how to use the edit window.  Pressing the 'OK' gadget will add
  1239.         the  current  entry,  'Cancel' will abort the edit and not add
  1240.         the entry.
  1241.  
  1242. 9.2.4   Selecting  the  'Abort!'  gadget will remove the window.  This
  1243.         equals pressing the upper lefthand closegadget.
  1244.  
  1245. 9.2.5   Selecting  the 'Load' gadget will bring up a file requester in
  1246.         the  center  of  the  screen.   For instructions on how to use
  1247.         this, see "The file input-requester" above.  From here you may
  1248.         load  a new phonebook.  Remember to save the current phonebook
  1249.         if  any  changes  have been made.  Entering "NComm.phone" will
  1250.         load the phonebook that is normally loaded at startup.
  1251.  
  1252. 9.2.6   Selecting  the 'Save' gadget will bring up a file requester in
  1253.         the  center  of  the  screen.   For instructions on how to use
  1254.         this, see "The file input-requester" above.  From here you may
  1255.         save  the  current phonebook.  Enter the name "NComm.phone" if
  1256.         you want the phonebook to be loaded at startup.
  1257.  
  1258. 9.2.7   Selecting the 'Delete' gadget will delete the entries that are
  1259.         currently selected.
  1260.  
  1261. 9.2.8   Selecting  the  'Sort'  gadget  will sort the phonebook.  If a
  1262.         entry  has  been  selected,  the  function  will only sort the
  1263.         entries between this entry and down.  If multiple entries have
  1264.         been selected, the function will only sort the entries between
  1265.         the top and lower entry.
  1266.  
  1267.         This  can  be handy if you are using hot keys to dial numbers,
  1268.         and  don't  want the upper entries mixed with entries that are
  1269.         lower  on  the  list, or if you prefer using the DIAL menu for
  1270.         dialling  entries and don't want entry 45 and down to be mixed
  1271.         with the upper entries.
  1272.  
  1273. 9.2.9   Selecting  the  'Print' gadget will print the phonebook. Enter
  1274.         the name of the file in the  righthand  text  gadget,  or  use
  1275.         "PRT:" if you want output sent to the printer. If  no  entries
  1276.         are selected, the whole phonebook will be printed. Else,  only
  1277.         the entries selected will be printed.
  1278.  
  1279. 9.3 Dial #
  1280.         This  requester  will dial a number which is not listed in the
  1281.         phonebook.  If redial has been turned on, the program will try
  1282.         reaching  the  number  until  connection has been established.
  1283.         This function can be used together with the dial queue.
  1284.  
  1285. 9.4 Hang up
  1286.         Selecting  this  entry  will send the HANGUP command string to
  1287.         the modem.
  1288.  
  1289. 9.5 Redial
  1290.         By configuring this option, NComm will try over and over again
  1291.         when a board you are calling is busy.
  1292.  
  1293. 9.6 Modem setup
  1294.         Within  this  requester  you may configure the things that are
  1295.         sent and received by the modem, and how long NComm should wait
  1296.         before  redialling.   Simply click in the text gadgets to edit
  1297.         them. The  setup  strings  can  contain the control characters
  1298.         listed under the explanation of 'macrokeys'.
  1299.  
  1300. 9.6.1   The  'initialization  string'  will  be sent to the modem soon
  1301.         after  NComm opens the serial device and before keyboard input
  1302.         is  accepted.   It  can be left blank, but remember that NComm
  1303.         requires  'echo'  from  the  modem,  so  it  can  be clever to
  1304.         configure  this here.  This can be accomplished by the 'AT E1'
  1305.         command if your modem is Hayes compatible.
  1306.  
  1307.         You  must  also set your modem to detect the BUSY signal if it
  1308.         has got such a feature.  If you have problems configuring your
  1309.         modem,  the 'AT &F\n' line will load the factory configuration
  1310.         on  Hayes compatibles.  This configuration is usually accepted
  1311.         by NComm.
  1312.  
  1313. 9.6.2   The  'exit  string'  is  sent just before the serial device is
  1314.         closed, when exiting NComm.  It is normally left blank.
  1315.  
  1316. 9.6.3   'Dial  prefix'  is  the  command  to  be  inserted  before the
  1317.         phonenumber.   For  Hayestype  modems, this should be ATDT (or
  1318.         ATDP for pulse dial).
  1319.  
  1320. 9.6.4   'Dial suffix' is the string to be added after the phonenumber.
  1321.         For  Hayestype  modems, this should be '\n', which will send a
  1322.         carriage return.
  1323.  
  1324. 9.6.5   'Hang-up  string' is the string to be sent when you choose the
  1325.         Hangup   function.   For  Hayestype  modems,  this  should  be
  1326.         '\w\w+++\w\w\w\wATH\n' (Wait 1 sec +++ Wait 2 sec ATH CR).
  1327.  
  1328. 9.6.6   The 'disconnect string' is the string sent from the modem when
  1329.         a  call  has  ended.  For Hayestype modems, this should be 'NO
  1330.         CARRIER'.
  1331.  
  1332. 9.6.7   The  'connect  string'  is the string sent from the modem when
  1333.         you  get  connected  to  a  board.  For Hayestype modems, this
  1334.         string should be 'CONNECT'.
  1335.  
  1336. 9.6.8   The  'busy  string' is the string sent from the modem when the
  1337.         phone  is  busy.   For  Hayestype modems this string should be
  1338.         'BUSY',  but  if  your  modem is having problems detecting the
  1339.         busy signal, enter this as 'NO CARRIER'.
  1340.  
  1341. 9.6.9   In the delay box you may specify how many seconds NComm should
  1342.         wait  before  redialling.   This delay is normally set to '3',
  1343.         but  enter  this  as  '0' if you have used 'NO CARRIER' as the
  1344.         BUSY string.
  1345.  
  1346. 9.6.10  Auto-speed  is  a  feature  that normally should be turned on.
  1347.         When connected, NComm will look for the number specified right
  1348.         after  the  'CONNECT'  message, and will switch to this speed.
  1349.         This  feature  should be turned off if you have set a constant
  1350.         speed between the modem and the machine, or if you are certain
  1351.         that the hostmodem supports the speed that you are calling at.
  1352.         I.e, turn auto-speed of if you are using a HST modem. To  make
  1353.         this  feature  work,  it is important that you have told  your
  1354.         modem to report the baudrate sent after the 'CONNECT' message.
  1355.         This  is done, again on Hayes, with the command 'AT V1 X2'.
  1356.  
  1357. 9.6.11  Pressing  the  'OK' gadget will accept the edit, 'Cancel' will
  1358.         leave everything unchanged.
  1359.  
  1360.  
  1361. 9.7     Edit window
  1362.         -----------
  1363.         The  edit  window  contains  six  text  input  boxes and eight
  1364.         gadgets.
  1365.  
  1366. 9.7.1   In  the  text  input  box marked 'Name', enter the name of the
  1367.         board.
  1368.  
  1369.         The  name  can  be up to 40 characters long, however, only the
  1370.         first  17  characters  will  be displayed in the dial menu and
  1371.         window, and in the logfile.  You can not leave this empty.
  1372.  
  1373. 9.7.2   In  the text input box marked 'Phone #', enter the phonenumber
  1374.         to  the current board.  The phonenumber can be up to 60 digits
  1375.         long.   If  a board has multiple numbers, enter them separated
  1376.         by  the  '|' character, for example "416588|410403".  Only the
  1377.         first  17 characters will be displayed in the dial window, and
  1378.         in the logfile.  This field can not be omitted.
  1379.  
  1380. 9.7.3   In  the  text  input  box  marked 'Comment', enter an optional
  1381.         comment,  like  when  the board is open, what the main purpose
  1382.         with  the  board  is,  if MNP is available or which speeds are
  1383.         available.  The comment can be 40 characters long.
  1384.  
  1385. 9.7.4   In  the  text  input  box marked 'Config', you may specify the
  1386.         name  of  an  optional  configuration  file.   The filename is
  1387.         relative  to  the  current  directory.  It will be loaded just
  1388.         after  dialling.   The  colors,  screen mode and menu settings
  1389.         will   be   changed  back  to  the  way  they  were  when  the
  1390.         configuration  file  was  saved.   The phonebook settings have
  1391.         higher  priority  than the settings found in the configuration
  1392.         file.
  1393.  
  1394. 9.7.5   In  the  text  input  box marked 'Macros', you may specify the
  1395.         name  of an optional macrokeys file.  The filename is relative
  1396.         to  the  current  directory.   It  will  be  loaded just after
  1397.         dialling.
  1398.  
  1399. 9.7.6   In  the  text  input  box marked 'Script', you may specify the
  1400.         name  of  an optional scriptfile.  The filename is relative to
  1401.         the  current  directory.   It will be loaded and executed just
  1402.         after  dialling,  which  means  that the scriptfile should not
  1403.         contain the 'dial' command as the first entry.
  1404.  
  1405. 9.7.7   In  the  text input box marked 'Password', you may specify the
  1406.         name of an optional password.  This can be handy if you prefer
  1407.         only using one scriptfile for multiple boards.  The scriptfile
  1408.         can  then  contain a 'SEND "\p\n"' command line that sends the
  1409.         password  configured  for the current board.  The password can
  1410.         also be sent by configuring '\p\n' on one of the macrokeys.
  1411.  
  1412.         Pressing  'return'  in  one of the text input boxes will bring
  1413.         the  cursor  to the text input box below the current box.  The
  1414.         cursor  will  be  brought to the top if 'return' is pressed in
  1415.         the bottom box.
  1416.  
  1417. 9.7.8   Pressing the gadget marked 'Baud rate' will multiply the board
  1418.         rate which is to be used for the board by two.  However, since
  1419.         NComm  only  supports  board  rates up to 19200 baud, the baud
  1420.         rate will revert to 300 baud when this baudrate is present.
  1421.  
  1422. 9.7.9   Pressing the gadget marked 'Data length' will switch between 7
  1423.         and  8  bits  data length.  This data length will be used when
  1424.         NComm dials the board.
  1425.  
  1426. 9.7.10  Pressing  the gadget marked 'Parity' will switch between Even,
  1427.         Odd  and  None  parity.   This  parity will be used when NComm
  1428.         dials the board.
  1429.  
  1430. 9.7.11  Pressing  the  gadget marked 'Stop bits' will switch between 1
  1431.         and  2  stop bits.  This number of stop bits will be used when
  1432.         NComm dials the board.
  1433.  
  1434. 9.7.12  Pressing  the  gadget marked 'Duplex mode' will switch between
  1435.         Full  and  Half  duplex.   This  duplex mode will be used when
  1436.         connection is established.
  1437.  
  1438. 9.7.13  Pressing the gadget marked 'Character set' will switch between
  1439.         IBN, IBP, US7, UK7, GE7, FR7, SP7, IT7, DE7, NO7, SF7, ISO and
  1440.         IBM  translation.   If  the  IBM or IBN character set has been
  1441.         chosen,  a special IBM graphics font will be used.  ISO should
  1442.         be  used  for  Amiga  boards  only.   The other character sets
  1443.         should  be  used on machines only having a 7-bit character set
  1444.         available.    By   watching  the  first  two  letters  in  the
  1445.         translation  name,  you may easily find out which one is to be
  1446.         used  for  your country.  This character set will be used when
  1447.         connection is established.
  1448.  
  1449.  
  1450.  
  1451. CHAPTER 10: INFORMATION ABOUT DIAL MENU
  1452.  
  1453.      Use  this  menu  for  fast  dialling of entries in the phonebook.
  1454.      Simply choose the board you would like to dial from the menu.
  1455.  
  1456.      Choosing  a  entry will bring up a small window telling you which
  1457.      board  you  are calling.  From here you may add more entries from
  1458.      the  menu, and set up a dial queue.  The window will at all times
  1459.      tell you which board is the next to dial.
  1460.  
  1461.      If  a  number  is  busy,  the program will continue with the next
  1462.      board  on  the  list.   If  redial has been turned on, NComm will
  1463.      start  over  again if no connection has been established with any
  1464.      of  the boards in the queue.  It will not stop until a connection
  1465.      has been established.
  1466.  
  1467.      NComm  will  abort  the dialling if it receives any text from the
  1468.      modem during the redial delay.
  1469.  
  1470.      Abort  the dialling by pressing the ESC key or closing the window
  1471.      by  clicking  in  the  upper lefthand closegadget.  To remove the
  1472.      current  entry,  press  the  DEL key.  Press the SPACE key if you
  1473.      would  like  to  go  on  with the next entry.  You may also click
  1474.      within the window gadgets.
  1475.  
  1476.  
  1477.  
  1478. CHAPTER 11: HOT KEYS AVAILABLE
  1479.  
  1480.      Are  you  fed  up  with  menus and mice and want to use something
  1481.      quicker  instead?   Look  no  further - NComm offers hot keys for
  1482.      most important functions.
  1483.  
  1484.      Hot Key                 Function
  1485.      -------                 --------
  1486.  
  1487.      Right Amiga A          About NComm
  1488.      Right Amiga B          Sends a 250ms break signal
  1489.      Right Amiga C          Start/end ASCII Capture
  1490.      Right Amiga D          Download
  1491.      Right Amiga E          Enter phonebook
  1492.      Right Amiga F          Execute script file on/off
  1493.      Right Amiga G          Palette
  1494.      Right Amiga H          Hang up phone
  1495.      Right Amiga I          Toggle interlace
  1496.      Right Amiga J          Save scrollback
  1497.      Right Amiga K          Split screen
  1498.      Right Amiga L          Load configuration
  1499.      Right Amiga M          Macrokeys
  1500.      Right Amiga N          Dial number
  1501.      Right Amiga O          Modem set-up
  1502.      Right Amiga P          Printer on/off
  1503.      Right Amiga Q          Quit NComm
  1504.      Right Amiga R          Reset
  1505.      Right Amiga S          Start/end ASCII Send
  1506.      Right Amiga T          Toggle title bar
  1507.      Right Amiga U          Upload
  1508.      Right Amiga V          View scrollback
  1509.      Right Amiga W          Save configuration
  1510.      Right Amiga Y          Message upload
  1511.      Right Amiga Z          New Cli
  1512.  
  1513.      Right Amiga #          (# is one of the keys 1,2,3,4,5,6,7,8,9,0)
  1514.                             This  sequence  will dial one of the first
  1515.                             10 entries in the phone directory.
  1516.  
  1517.      HELP key               Status
  1518.  
  1519.      The  CONTINUE  and  APPEND  options can be answered with the LEFT
  1520.      AMIGA  V key.  The CANCEL and DELETE options can be answered with
  1521.      the  LEFT  AMIGA  B  key.  You can of course click the left mouse
  1522.      button over these selections as well.
  1523.